ByteFisher

钓鱼爱好者的编程世界

ByteFisher AI 编程实战（七）：Claude Code 终端AI编程实战

发表于 分类于 ， Waline：
本系列第7篇，共21篇。详细介绍 Claude Code 终端 AI 编程助手的安装配置、核心命令详解，以及接入国产大模型（DeepSeek/Qwen/MiniMax）的实战配置。

如果说 Copilot 是”骑着 AI 写代码”，Cursor 是”和 AI 一起写代码”，那 Claude Code 就是让 AI 替你写代码。它是一个终端工具，通过自然语言指令直接操作你的项目文件。

一、Claude Code 是什么

Claude Code 是 Anthropic 推出的终端 AI 编程助手。与 Copilot 和 Cursor 不同，它不需要打开编辑器——直接在终端中用自然语言描述需求，它就能读取、修改、创建项目文件，甚至执行命令和 Git 操作。

特性 说明
运行方式 终端 CLI 工具，不依赖 GUI 编辑器
核心能力 读写文件、执行 Shell 命令、Git 操作、全项目理解
适用场景 批量重构、脚手架生成、大规模代码迁移、自动化脚本
上下文窗口 200K Token（Claude 4），能容纳整个中型项目
价格 API 按量计费，每次会话根据 Token 用量付费
优势 无环境依赖，SSH 远程服务器也能用

Claude Code 的核心工作流是”对话即操作”：你下指令，它执行操作并返回结果，你可以继续追问或调整。这种交互方式特别适合需要跨文件操作的重构任务。

二、安装与配置

2.1 安装

1
2
3
4
5
6
7
8
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

# 验证
claude --version

2.2 首次使用

安装完成后运行 claude，首次启动需要：

  1. 登录 Anthropic 账号（如果没有，先在 claude.ai 注册）
  2. 绑定 API Key（在 Anthropic Console 中创建）
  3. 选择模型版本（Claude 4 Sonnet 性价比最高）
1
2
3
4
5
# 启动交互式会话
claude

# 首次启动会引导完成 API Key 配置
# 配置保存在 ~/.claude.json

2.3 配置代理（可选）

如果所在网络需要代理访问海外 API：

1
2
3
# 设置 HTTPS 代理
export HTTPS_PROXY=http://127.0.0.1:7890
claude

三、接入国产大模型

通过 cc-switch 工具可以轻松配置国产模型替代 Claude：

1
2
npm install -g cc-switch
cc-switch

运行后通过交互界面选择目标模型，cc-switch 会自动修改 Claude Code 的配置，使其调用指定的国产模型 API。

3.1 支持的国产模型

模型 厂商 代码能力 上下文 价格（每百万 Token） 延迟
DeepSeek-V3 深度求索 四星 128K 1 元 低
DeepSeek-R1 深度求索 五星 128K 4 元 中（思维链）
Qwen2.5-Coder-32B 阿里云 四星 128K 3.5 元 低
MiniMax-M2.7 MiniMax 四星 256K 2 元 低
GLM-5 智谱 四星 128K 3 元 中

3.2 模型选择建议

  • 日常编码：DeepSeek-V3（性价比最优，速度快）
  • 复杂重构：DeepSeek-R1（思维链推理，处理复杂逻辑）
  • 超大上下文：MiniMax-M2.7（256K 上下文）
  • 中文优化：Qwen2.5-Coder（中文理解最佳）

四、核心命令实战

4.1 基础命令

1
2
3
4
5
6
7
8
# 启动交互式会话
claude

# 直接执行单条指令（非交互模式）
claude -p "检查这个项目的 package.json 是否有过时的依赖"

# 传入文件作为上下文
claude -p "帮我优化这个文件的性能" src/utils.ts

4.2 项目生成

1
2
3
4
5
6
7
8
9
10
# 生成新项目
"创建一个 Express + TypeScript 的 REST API 项目，
 包含用户注册登录功能，使用 Prisma ORM + SQLite"

# Claude Code 会：
# 1. 创建目录结构
# 2. 初始化 package.json
# 3. 安装依赖
# 4. 生成所有源文件
# 5. 初始化 Git 仓库

4.3 批量重构

1
2
3
4
5
6
7
8
"将 src/ 下所有 .js 文件重命名为 .ts，
 并添加 TypeScript 类型声明"

# Claude Code 会逐个文件处理：
# - 分析每个文件的导出类型
# - 添加接口和类型定义
# - 重命名文件
# - 更新所有引用路径

4.4 代码迁移

1
2
"将项目中的 jQuery 代码全部替换为原生 JavaScript，
 每次修改前先展示 diff，我确认后再执行"

4.5 内置斜杠命令

在 Claude Code 会话中可以直接使用斜杠命令：

命令 作用 使用场景
/compact 压缩对话历史 长会话后清理上下文
/cost 显示当前会话 Token 用量和费用 控制预算
/diff 查看最近修改的 diff 审查修改
/init 初始化项目配置文件 新项目
/doctor 检查项目问题 诊断配置错误

五、安全最佳实践

5.1 权限控制

1
2
3
4
5
6
7
8
# 预览 AI 将要做的修改（不实际写入）
claude --dry-run

# 限制文件操作范围
claude --allow-read="src/**" --allow-write="src/**"

# 禁止某些目录
claude --ignore-patterns="node_modules/**,dist/**,.git/**"

5.2 审查流程

使用 Claude Code 的标准工作流：

  1. 先预览：使用 --dry-run 查看计划
  2. 询问修改：让 AI 用 --diff 展示变更
  3. 逐文件确认：分步骤接受修改
  4. 版本管理：每次 AI 操作后 git commit 一次
  5. 回滚准备：保持 Git 工作区干净，方便 git revert

六、Claude Code 的常见问题排查

问题 原因 解决
API Key 认证失败 Key 过期或权限不足 在 Anthropic Console 检查 Key 状态
上下文超出限制 项目中文件过多 启动时指定只看关键目录：claude --ignore-patterns="test/**"
模型响应慢 国产模型 API 延迟高 切换模型：cc-switch 选 DeepSeek-V3（延迟最低）
文件操作失败 权限不足 检查目录权限，使用 --allow-write 明确指定
输出截断 达到 Token 限制 使用 /compact 压缩对话，或分步骤操作
Git 冲突 AI 修改时未先拉取最新代码 操作前先 git pull，操作后立即 git commit

6.1 性能优化建议

  1. 大型项目分批操作：不要一次处理整个 monorepo，先告诉 AI 聚焦到某个子目录
  2. 保持会话简短：长会话后 Token 消耗剧增，及时使用 /compact
  3. 合理使用 ignore-patterns：排除 node_modules、dist、.git 等目录
  4. 善用 –dry-run：复杂操作前先预览，避免意外修改

七、进阶技巧

6.1 批量修改模式

处理大规模代码库时，分步骤操作比一次性指令效果更好：

1
2
3
第1轮："找出所有使用了已废弃 API 的文件，列出清单"
第2轮："逐个文件替换这些 API 调用，每次修改前展示 diff"
第3轮："添加单元测试验证修改的正确性"

6.2 与 Cursor / Copilot 的协同

场景 推荐工具 原因
写新函数 Copilot 实时补全，键盘不离手
改单个组件 Cursor Cmd+K 内联编辑，即时预览
跨文件重构 Claude Code 终端操作，批量处理
生成项目脚手架 Claude Code 一次生成整个项目结构
调试运行时错误 Cursor Chat 可在编辑器中直接查看代码上下文

七、实战案例：从零生成 REST API 项目

用 Claude Code 生成一个完整的用户管理系统：

1
claude
1
2
3
4
5
6
7
8
指令：
创建一个 Express + TypeScript 的 REST API 项目，包含：
1. 用户注册（邮箱+密码，密码 bcrypt 加密）
2. 用户登录（JWT Token）
3. 获取用户信息（需认证）
4. 使用 Prisma ORM + SQLite
5. 请求参数校验（zod）
6. 错误处理中间件

Claude Code 会输出每一步的操作日志：

1
2
3
4
5
6
7
8
9
10
✓ 创建 project structure
✓ package.json with dependencies
✓ TypeScript config
✓ Prisma schema (User model)
✓ Auth routes (register/login/me)
✓ Middleware (auth, validation, error)
✓ Install dependencies
✓ Initialize Git repo

总计创建 12 个文件，耗时约 45 秒。

八、Claude Code 与 CI/CD 集成

Claude Code 可以集成到 CI 流程中，实现 AI 驱动的自动化代码审查：

1
2
3
4
5
6
7
8
9
10
11
12
13
# .github/workflows/claude-review.yml
name: Claude Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Claude Code Review
        run: |
          claude -p "审查这个 PR 的代码变更，
          关注安全漏洞和性能问题，
          按严重程度排序输出" --output-format markdown

本章小结

  • Claude Code 是终端 AI 编程助手，适合批量操作和大范围重构
  • 国产模型可通过 cc-switch 接入，DeepSeek 系列性价比最高
  • 支持 –dry-run 预览模式、目录级权限控制
  • 内置斜杠命令 /compact /cost /diff 提升使用体验
  • 和 Cursor 互补使用效果最佳：Claude Code 做大范围重构，Cursor 做精准编辑
  • 使用 Claude Code 前务必做好 Git 提交，方便回滚

下一篇进入编程应用篇，先看 AI 如何辅助前端开发。

ByteFisher
分享编程技术 · 记录钓鱼乐趣
扫码关注
▸ 扫码关注 ◂
相关文章
ByteFisher AI 编程实战（十）：AI辅助Unity开发（上）——脚本与逻辑2026-07-08本系列第10篇，共21篇。深入实战 AI 辅助 Unity 开发，聚焦 C# 脚本生成、游戏逻辑编写、组件系统交互和动画物理控制，结合 Cursor 和 Copilot 提升 Unity 开发效率。ByteFisher AI 编程实战（九）：AI辅助后端开发2026-07-05本系列第9篇，共21篇。实战讲解 AI 辅助后端开发，涵盖 Python/Node.js API 生成、数据库设计与 SQL 生成、完整 CRUD 实现和错误处理，帮你快速搭建后端服务。ByteFisher AI 编程实战（八）：AI辅助前端开发2026-07-01本系列第8篇，共21篇。实战讲解如何用 AI 辅助前端开发，从 HTML/CSS/JS 生成到 React/Next.js 项目构建，涵盖页面设计、交互功能、响应式布局和调试优化全流程。ByteFisher AI 编程实战（六）：Cursor——为AI而生的编辑器2026-06-24本系列第6篇，共21篇。深入介绍 Cursor 编辑器的核心功能——Tab 补全、Cmd+K 生成、Composer 多文件编辑、项目上下文管理和 .cursorrules 规则编写，并与 VS Code + Copilot 全面对比。ByteFisher AI 编程实战（五）：GitHub Copilot 从入门到精通2026-06-21本系列第5篇，共21篇。全面讲解 GitHub Copilot 的安装配置、代码补全技巧、Chat 与 Inline Chat 的使用方法，以及测试生成、遗留代码理解等高级场景实战。ByteFisher AI 编程实战（四）：AI编程的编程语言基础2026-06-17本系列第4篇，共21篇。搭建 AI 编程所需的开发环境——Python、Node.js、Git、VS Code 的安装配置，以及必备插件推荐，为后续工具实战打下坚实基础。
ByteFisher AI编程实战教程 系列
第 7/10 篇
ByteFisher AI 编程实战（六）：Cursor——为AI而生的编辑器ByteFisher AI 编程实战（八）：AI辅助前端开发
分享：
淡水鱼
淡水鱼
钓鱼爱好者 & Unity 游戏开发者，分享编程技术与钓鱼经验。